From b5af7163a185faee49d8621a3707d238b0fc0a55 Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Thu, 8 Jun 2006 01:25:43 +0000 Subject: [PATCH] Add some docs. 2006-06-07 Matthias Clasen * gtk/gtkprintoperation.c: Add some docs. * gtk/gtk.symbols: Add gtk_print_operation_set_allow_async. * gtk/gtkprintoperation.h: Remove gtk_print_operation_run_async. --- ChangeLog | 6 ++++++ ChangeLog.pre-2-10 | 6 ++++++ gtk/gtk.symbols | 1 + gtk/gtkprintoperation.c | 15 +++++++++++++-- gtk/gtkprintoperation.h | 2 -- 5 files changed, 26 insertions(+), 4 deletions(-) diff --git a/ChangeLog b/ChangeLog index 913a8209c5..24cd29846d 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,5 +1,11 @@ 2006-06-07 Matthias Clasen + * gtk/gtkprintoperation.c: Add some docs. + + * gtk/gtk.symbols: Add gtk_print_operation_set_allow_async. + + * gtk/gtkprintoperation.h: Remove gtk_print_operation_run_async. + * tests/testnotebookdnd.c: Update callers. * gtk/gtknotebook.h: diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10 index 913a8209c5..24cd29846d 100644 --- a/ChangeLog.pre-2-10 +++ b/ChangeLog.pre-2-10 @@ -1,5 +1,11 @@ 2006-06-07 Matthias Clasen + * gtk/gtkprintoperation.c: Add some docs. + + * gtk/gtk.symbols: Add gtk_print_operation_set_allow_async. + + * gtk/gtkprintoperation.h: Remove gtk_print_operation_run_async. + * tests/testnotebookdnd.c: Update callers. * gtk/gtknotebook.h: diff --git a/gtk/gtk.symbols b/gtk/gtk.symbols index 0af6aad0cb..545c26f05a 100644 --- a/gtk/gtk.symbols +++ b/gtk/gtk.symbols @@ -2688,6 +2688,7 @@ gtk_print_job_get_track_print_status gtk_print_error_quark gtk_print_operation_get_type G_GNUC_CONST gtk_print_operation_new +gtk_print_operation_set_allow_async gtk_print_operation_set_default_page_setup gtk_print_operation_get_default_page_setup gtk_print_operation_set_print_settings diff --git a/gtk/gtkprintoperation.c b/gtk/gtkprintoperation.c index 861d482acd..b0ecbce6bd 100644 --- a/gtk/gtkprintoperation.c +++ b/gtk/gtkprintoperation.c @@ -1025,7 +1025,7 @@ gtk_print_operation_class_init (GtkPrintOperationClass *class) * * Determines whether the print operation may run asynchronous or not. * Some systems don't support asynchronous printing, but those that do - * will return GTK_PRINT_OPERATION_RESULT_IN_PROGRESS as the status, and + * will return %GTK_PRINT_OPERATION_RESULT_IN_PROGRESS as the status, and * emit the done signal when the operation is actually done. * * Since: 2.10 @@ -1607,6 +1607,17 @@ gtk_print_operation_set_show_progress (GtkPrintOperation *op, } } +/** + * gtk_print_operation_set_allow_async: + * @op: a #GtkPrintOperation + * @allow_async: %TRUE to allow asynchronous operation + * + * Sets whether the gtk_print_operation_run() may return + * before the print operation is completed. Note that + * some platforms may not allow asynchronous operation. + * + * Since: 2.10 + */ void gtk_print_operation_set_allow_async (GtkPrintOperation *op, gboolean allow_async) @@ -2300,7 +2311,7 @@ gtk_print_operation_get_error (GtkPrintOperation *op) * @op to obtain some information about the progress of the print operation. * Furthermore, it may use a recursive mainloop to show the print dialog. * - * If you call gtk_print_operation_set_allow_async () or set the allow-async + * If you call gtk_print_operation_set_allow_async() or set the allow-async * property the operation will run asyncronously if this is supported on the * platform. The ::done signal will be emitted with the operation results when * the operation is done (i.e. when the dialog is canceled, or when the print diff --git a/gtk/gtkprintoperation.h b/gtk/gtkprintoperation.h index ac144f4ff3..d524223cdf 100644 --- a/gtk/gtkprintoperation.h +++ b/gtk/gtkprintoperation.h @@ -176,8 +176,6 @@ GtkPageSetup *gtk_print_run_page_setup_dialog (GtkWindow typedef void (* GtkPageSetupDoneFunc) (GtkPageSetup *page_setup, gpointer data); -void gtk_print_operation_run_async (GtkPrintOperation *op, - GtkWindow *parent); void gtk_print_run_page_setup_dialog_async (GtkWindow *parent, GtkPageSetup *page_setup, GtkPrintSettings *settings, -- 2.30.2